home *** CD-ROM | disk | FTP | other *** search
/ Amiga Developer CD 2.1 / Amiga Developer CD v2.1.iso / Contributions / Haage_&_Partner / StormC / StormC_3.0 / Readme < prev    next >
Encoding:
Text File  |  1998-08-09  |  6.6 KB  |  224 lines
  1. © HAAGE & PARTNER Computer GmbH 
  2.  
  3.   Schlossborner Weg 7
  4.   D-61479 Glashuetten
  5.   Germany
  6.  
  7.   Tel: ++49  61 74 / 96 61 00
  8.   Fax: ++49  61 74 / 96 61 01
  9.  
  10.   Internet: storm-support@haage-partner.com
  11.   Homepage: http://www.haage-partner.com
  12.  
  13. First of all we want to thank you for purchasing StormC. So you told
  14. us that we did the right thing by developing StormC.
  15.  
  16. These are the changes in comparison to Version 1.1:
  17. ======================================================================
  18.  
  19. StormShell
  21. - Expandet optiondialog
  22. - GoldED 4.0 is includet in the package
  23.  
  24. Project Manager
  26. - Make of hierarchical projects
  27. - Own ARexx-Makescripts
  28. - New project section for StormLibrarian
  29.  
  30. StormEd
  32. - bracket-check
  33. - block indent
  34. - new colour controls
  35. - new project template
  36.  
  37. StormRun
  39. - Stack and CPU register window
  40. - Disassembler
  41. - Profiler
  42.  
  43. StormC
  45. - new optimisation levels
  46. - new keyword "__interrupt"
  47.  
  48. StormLibrarian
  50. - simple creation of linker libraries
  51. - Sort function
  52.  
  53. Tools
  55. - FD2Pragma
  56.  
  57.  
  58. Editor Key Map:
  59. ************************
  60.  
  61. Shift-Cursor Up/Down
  62.         Moves the cursor to the first/last line displayed in the window.
  63.  
  64. Shift-Cursor Left/Right
  65.         Moves the cursor to the first/last column of the current line.
  66.  
  67. Alt-Cursor Up/Down
  68.         Jumps to the start/end of the text.
  69.  
  70. Alt-Cursor Left/Right
  71.         Moves the cursor to the next word in front of or behind the cursor.
  72.  
  73. Shift-Delete oder Shift-Backspace
  74.         Deletes the line the cursor stands. It is stored in the clipboard.
  75.  
  76. Alt-Delete
  77.         Deletes the line starting form the position of the cursor to the end.
  78.  
  79. Alt-Backspace
  80.         Deletes the text from the start to the cursor position.
  81.  
  82. Help
  83.   Opens the Online Help and displays an explanation to the word under the cursor.
  84.   The word must be an ANSI-C or C++ standard function.
  85.  
  86.  
  87. Advices to PhxAssembler
  88. ************************
  89.  
  90. As a bonus the freeware assembler FreePhxAss is delivered with
  91. StormC. It is mainly for useful for developers of PD compilers which
  92. use it for translation of their compiler output. The function size
  93. is *very* limited: There are no macros, no includes, no conditioned
  94. assembling. Many directives are also not available. 
  95.  
  96. FreePhxAss can be used freely, but the name of the Author should
  97. be mentioned in the project.
  98.  
  99. If you are interested in PhxAss, there is a registered version that
  100. is available at a low price.
  101.  
  102. Please contact
  103.  
  104. SMail:                  Frank Wille
  105.                         Auf dem Dreische 45
  106.                         32049 Herford
  107.                         Germany
  108.  
  109. EMail:                  frank@phoenix.owl.de
  110.  
  111.  
  112. Some Frequently asked Questions and Answers !
  113. *****************************************
  114. Q 1:
  115. ********
  116.  
  117. Why has StormC no Global Optimiser" ?
  118.  
  119. Answer:
  120. The compiler of StormC offers already a good optimisations. Some of
  121. the used techniques are also part of a global optimiser. Especially
  122. the optimised organisation of the global CPU and FPU registers is such
  123. a one.
  124.  
  125. StormC is already prepared to do more of the global optimisations in
  126. further versions. They can be implemented step by step. But as said
  127. before the optimisation of StormC and StormLINK. 
  128.  
  129. Q 2:
  130. ********
  131.  
  132. Why does a small "Hello World" gets so long (some Kbytes) ?
  133.  
  134. Answer:
  135. "Storm.lib" is a highly compatible ANSI C library that offers buffered I/O.
  136.  
  137. The program "Hello World" uses "printf" of the "Storm.lib", but it
  138. does not differ between the output of integer or floating point, so
  139. there are unused parts of the library in your code that makes small
  140. programs relatively large.
  141.  
  142. If only ANSI C is used the library "StormAmiga.lib" can be used. This
  143. is a highly optimised assembler library that generates very small and
  144. fast programs. It only supports "far code" and "far data" model.
  145.  
  146. Q 3:
  147. ********
  148.  
  149. How can I get a short "Hello World" using Storm.Lib ?
  150.  
  151. Answer:
  152. If floating point is needed and buffered I/O of AmigaDOS is enough
  153. AmigaDOS functions can be used for this. "Vprintf" and "VFPrintf"
  154. will directly output to AmigaDOS files, just like "printf". But these
  155. functions are not 100% ANSI compatible.
  156.  
  157. Another possibility is to resign on automatically open and close of
  158. libraries and its comfortable error handling which differs between
  159. Workbench and CLI start while paying attention to OS 1.3 and older.
  160. This comfort is not necessary for all programs.
  161.  
  162. So a minimal startup code, written in assembler can be used, that only
  163. does the essential jobs, e.g. only supporting the small data model,
  164. not supporting resident programs ...
  165.  
  166. Q 4:
  167. ********
  168.  
  169. Why is the library "storm.lib" such a big one and why is there
  170. only a single one (in contrast to SAS/C) ?
  171.  
  172. Answer:
  173. StormC support a further developed object format that is used for
  174. linker libraries as well. It is 100% compatible to the old one. Its
  175. advantage is that the Linker and the Compiler of StormC can accommodate
  176. more data models in one object file. So the programmer must not decide
  177. which is the right library that fits the used data model (far data,
  178. near data(a4), near data(a6)). This caused many errors. Now the linker
  179. takes the needed parts out of "Storm.lib". For these reasons "Storm.lib"
  180. is nearly as big as these three libraries of SAS/C.
  181.  
  182. In the future StormC will support even more code modells and CPU and
  183. FPU models, so "Storm.lib" will allow the optimised program generation
  184. automatically.
  185.  
  186. Q 5:
  187. ********
  188.  
  189. Why does the linker displays the error message "Symbol _exit
  190. not defined", when linking as Shared Library ?
  191.  
  192. Answer:
  193. The Shared Library calls the ANSI function exit(). This can be done
  194. directly by the programmer or indirectly by the linker library which
  195. uses this function. "Storm.lib" uses this function to automatically
  196. open the used Shared Library, e.g. the "utility.library".
  197.  
  198. Basically a Shared Library is not allowed to use exit(), cause it
  199. can not be finished simply.
  200.  
  201. How to avoid this call ?
  202.  
  203. You should not use the automatic opening of used Shared Libraries.
  204. Instead you must open and close the library as it is described in
  205. the manual.
  206.  
  207. To get a list of all used libraries you should include
  208.  
  209. void exit() {}
  210.  
  211. into the Shared Library. Now you can link it.
  212.  
  213. You should use the linker option "Write Map File". The linker will
  214. generate a file with the extension ".map". Now watch all INIT
  215. functions which contain the basis name of the Shared Library, e.g.
  216. INIT_1_UtilityBase.
  217.  
  218. Now open all these libraries with your own routines. Pay attention
  219. to declare the corresponding basis variable (e.g. UtilityBase). Do not
  220. forget to remove your own exit() function from the source. 
  221.  
  222. (c) HAAGE & PARTNER Computer GmbH - We develop to WarpUp the AMIGA
  223.  
  224.